2021.1 (latest)

Task References

On this page:

convertEpochToObject (time)

Purpose

The convertEpochToObject task converts an Epoch timestamp into a date string with a specified time/date format.

Potential Use Case

Let's say you have a northbound system that is only capable of providing an Epoch timestamp. The convertEpochToObject task allows you to convert it into a human-readable timestamp for log files or other event records.

Properties

Incoming Type Description
epoch Number Required. The epoch timestamp to convert.
epochFormat Enum Required. The format of the epoch timestamp value. Allowed values are "Seconds" or "Milliseconds".
newFormatString String Optional. Represents the format in which the converted time should be displayed. Acceptable formats are identified in the moment.js documentation.


Outgoing Type Description
convertedTime Object The converted time value. Presented in the format specified by the newFormatString parameter.

Examples

Example 1

In this IAP example:

  • The epoch variable is provided by the output of the reference task convertTimeToEpoch, which is located located elsewhere in the workflow.

    Note: The convertTimeToEpoch task was used only to simulate an incoming Epoch timestamp for this example.

  • The reference variable provided by the convertTimeToEpoch task is epochTime.

  • The EpochFormat variable is set to Seconds.

  • The newFormatString variable is set to LLL, which is the momentum.js locale format for Month name, day of month, year, time.

  • For this example, the convertedTime produced upon output will be the value of the epoch timestamp presented in a human-readable format.

    convertEpochToObject01

Example 2

In this IAP example:

  • The epoch variable is provided by the output of the reference task convertTimeToEpoch, which is located located elsewhere in the workflow.

    Note: The convertTimeToEpoch task was used only to simulate an incoming Epoch timestamp for this example.

  • The reference variable provided by the convertTimeToEpoch task is epochTime.

  • The EpochFormat variable is set to Seconds.

  • The newFormatString property is set to DD-MMM-YY hh:mm a, which is a date time format for Day-Month-Year hour:min am/pm.

  • For this example, the convertedTime produced upon output will be the value of the epoch timestamp presented in a human-readable format.

    convertEpochToObject02

Example 3

In this IAP example:

  • The epoch property is statically set to the number 1591045860.

  • The EpochFormat property is set to Seconds.

  • The newFormatString property is set to DD-MMM-YY hh:mm a, which is a date time format for Day-Month-Year hour:min am/pm.

  • For this example, the convertedTime produced upon output will be the value of the epoch timestamp presented in a human-readable format. In this case the converted timestamp will be 01-Jun-20 09:11 pm.

    convertEpochToObject03